home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / os2 / hswtch04.zip / HSWITCH.TXT < prev   
Text File  |  1994-04-12  |  8KB  |  218 lines
  1.                          === DISCLAIMER ===
  2.  
  3.  
  4. I allow you to use and distribute HSWITCH freely under the
  5. condition that I am in no way responsible for any damage or
  6. loss you may suffer. 
  7.  
  8.  
  9. Henk Kelder, Fidonet 2:280/801.339
  10.  
  11. Notes about HSWITCH:
  12. ====================
  13.  
  14. HSWITCH is a program that allows you to switch sessions on OS/2 2.0 from
  15. within full screen sessions.
  16.  
  17. HSWITCH is a dual mode program. The .exe file actually contains TWO
  18. programs: A OS/2 program AND a TSR program for DOS.
  19.  
  20. For HSWITCH to work properly you need to have OS/2 2.1 or OS/2 2.0 AND
  21. the service pack installed. On OS/2 2.0 GA HSWITCH does not work properly.
  22.  
  23. General Installation for OS/2
  24. =============================
  25.  
  26. There are two ways to install HSWITCH:
  27.  
  28. 1. Add a "RUN=[path]HSWITCH.EXE [options] in your CONFIG.SYS
  29.  
  30. 2. Enter "DETACH [path]HSWITCH [options]" at a OS/2 command prompt
  31.  
  32. Valid options are:
  33.  
  34.         /Fnn : nn is first session number to monitor (default 4)
  35.         /Lnn : nn is last session number to monitor  (default 15)
  36.                See notes on version 1.3
  37.  
  38.         /Hnn : nn is the scancode of the HOTKEY. The default value for the 
  39.                hotkey is 53.
  40.                See notes on version 1.4
  41.  
  42.         /O   : Always popup using (the VioPopUp attribute) OPAQUE. 
  43.                OPAQUE means that HSWITCH will always create a popup screen
  44.                with dimensions 25x80 and that underlying screen will not
  45.                be visible.
  46.                This argument is usefull for users working with some SVGA
  47.                cards where popping up HSWITCH will make spaghetti of the
  48.                screen.
  49.                
  50.  
  51. Installation in a DOS box
  52. =========================
  53.  
  54. Simply run HSWITCH in a DOS (VDM or VMB) session, or better install in
  55. in your AUTOEXEC.BAT.
  56. It will install itself as an TSR program that will take round 9Kb of 
  57. RAM space.
  58. If the OS/2 version is not installed, the DOS version will NOT install.
  59.  
  60. When activated by its hotkey, HSWITCH will send a signal to the 
  61. OS/2 counterpart that will actually show the switchlist. 
  62.  
  63. Since the OS/2 program has no way to determine which DOS session has send 
  64. the signal the DOS program changes its session title for some moments to 
  65. "DOSSWITCH" so the OS/2 program can recoqnize the proper DOS session.
  66. The default duration of this title-change is 500 milliseconds which is
  67. sufficient for a 33 mHz 486 on normal operation.
  68. If HSWITCH never checkmarks the current DOS session when activated from DOS
  69. you could try to increase this value. Please note that the DOS program is
  70. blocked for the specified duration.
  71.  
  72. Note: HSWITCH can also be loaded and activated in a DOS window. Pressing 
  73. the hotkey there will however result in switching to full screen before the
  74. switchlist is displayed. 
  75.  
  76. HSWITCH does not work (the tasklist will not appear) while using WIN-OS/2.
  77.  
  78. Syntax :
  79.         [path]HSWITCH [options]
  80.  
  81. Valid options are:
  82.  
  83.         /Hnn : nn is the scancode of the HOTKEY. The default value for the 
  84.                hotkey is 53.
  85.                This options only has effect when specified while installing
  86.                See notes on version 1.4
  87.  
  88.         /Tnn : Specify the title-change duration in milliseconds. 
  89.                The default duration is 500 milliseconds. 
  90.  
  91.         /R   : When already installed, removes itself from memory
  92.  
  93. Activating
  94. ==========
  95.  
  96. To activate HSWITCH press the hot-key. This hot-key consist of two keys:
  97. Press and hold the <ALT> key en press the forward slash.
  98.  
  99. This keystroke causes a task list window to appear over the current
  100. screen.  A session can be selected by using the arrow keys, or by
  101. entering the first letter in the session title.
  102.  
  103. Once a session has been selected, you can enter any of the following
  104. keys:
  105.  
  106. <ENTER> - switches you to the highlighted session
  107. <ESC>   - places you back in the session you started in
  108. <ALT-X> - Removes the detached HSWITCH OS/2 background program
  109.  
  110.  
  111. Known bugs/limitations
  112. ======================
  113.  
  114. - HSWITCH may not become active from within an OS/2 session if you have more
  115.   than 20 or so sessions.
  116.  
  117. - When you activate HSWITCH from an DOS session the current session is
  118.   not always marked by the highlighted bar. Instead the first session might
  119.   highlighted while no session is check-marked. (See notes on version 1.4)
  120.  
  121. - On Version of OS/2 where only the initial release of OS/2 is installed
  122.   (GA) there are reports of traps when the DOS HSWITCH is used.
  123.  
  124. - HSWITCH uses box drawing characters to display itself and assumes you are
  125.   using codepage 437. If you are not using this Codepage some incorrect
  126.   characters might be used.
  127.  
  128. - When HSWITCH is activated from a DOS session, and the session is at a 
  129.   COMMAND Prompt, HSWITCH will show 'Current DOS' instead of the normal 
  130.   title. (feature, no bug).
  131.  
  132.  
  133.  
  134. Credits
  135. =======
  136.  
  137. The OS/2 Part of HSWITCH is based on the public domain "VSWITCH" program 
  138. by Scott Dudley. The DOS part is off my own hand.
  139.  
  140. VSWITCH is in turn based on a public domain program call "HOTKEY" by
  141. Peter Fitzsimmons and Dave Burton.  
  142.  
  143. HSWITCH is also public domain. The OS/2 code was compiled with 
  144. IBM C/2 Set 32 Bits compiler for OS/2 2.0. The DOS code was compiled with
  145. the Microsoft C version 6.0a compiler.
  146.  
  147.  
  148. =========================== HISTORY =======================================
  149. Notes on version 1.3:
  150.  
  151. o       You can now specify the first and last session that hswitch
  152.         monitors. The syntax is:
  153.  
  154.             run=[d:\path\]hswitch.exe /Fff /Lll (in the config.sys)
  155.                         or
  156.             detach [d:\path\]hswitch.exe /Fff /Lll (from the command line)
  157.  
  158.             where ff is the first session id and
  159.                   ll is the last session id.
  160.  
  161.         The defaults are 4 until 15.                
  162.         
  163.  
  164. o       When the DOS HSWITCH is used and the screen is not set on
  165.         25 lines, the screen background is cleared before the program
  166.         will popup.
  167.  
  168. o       If you run HSWITCH in the foreground it will show messages about
  169.         whats happening (debug messages mainly).
  170.  
  171.  
  172. Notes on version 1.4:
  173.  
  174. o       You can now specify the HOTKEY that HSWITCH uses.
  175.         Note that this hotkey must always be an ALT-combination.
  176.         The syntax is: 
  177.  
  178.                 [....]HSWITCH /Hnn 
  179.         
  180.         where nn must be a valid DECIMAL keyboard SCAN code.
  181.         Not all keys can be used. Some (e.g. the numeric keys and 
  182.         the tab key) simply don't work. Most alphabetic keys however work.
  183.         Just try it.
  184.         
  185.         Should you use the parameter make sure you specify 
  186.         the /H parameter both for the OS/2 version as for the DOS version 
  187.         the same.
  188.  
  189.         Please note that no checking is done!
  190.  
  191.         You'll find scancodes in your PC's manual.
  192.  
  193. o       The tasklist is shown in reversed order now. This normally matches
  194.         the order in the standard PM tasklist.
  195.  
  196. o       HSWITCH now tries to select the proper session when activated from
  197.         a DOS session. 
  198.  
  199.         However when it works, and the DOS session is at a COMMAND Prompt,
  200.         HSWITCH will show 'Current DOS' instead of the normal title. 
  201.         (feature, no bug).
  202.  
  203. o       When the DOS version was installed in upper memory using LH the
  204.         upper memory was not freed when the DOS version was deinstalled.
  205.         This has been corrected.
  206.  
  207.  
  208. Notes on version 1.5
  209.  
  210. o       Added the /O option. This option will make HSWITCH to use
  211.         the VioPopUp API call with the VP_OPAQUE flag instead of the
  212.         VP_TRANSPARENT flag. The flag will cause VioPopUp to always create
  213.         a cleard 25 by 80 characters popup screen.
  214.         This option may be usefull for people with some SVGA adapters where
  215.         using HSWITCH will make spaghetti of the screen.
  216.  
  217.        
  218.